home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / hplip / makeuri.py < prev    next >
Text File  |  2008-10-13  |  7KB  |  206 lines
  1. #!/usr/bin/env python
  2. # -*- coding: utf-8 -*-
  3. #
  4. # (c) Copyright 2003-2007 Hewlett-Packard Development Company, L.P.
  5. #
  6. # This program is free software; you can redistribute it and/or modify
  7. # it under the terms of the GNU General Public License as published by
  8. # the Free Software Foundation; either version 2 of the License, or
  9. # (at your option) any later version.
  10. #
  11. # This program is distributed in the hope that it will be useful,
  12. # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14. # GNU General Public License for more details.
  15. #
  16. # You should have received a copy of the GNU General Public License
  17. # along with this program; if not, write to the Free Software
  18. # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  19. #
  20. # Authors: Don Welch, Smith Kennedy
  21. #
  22.  
  23. __version__ = '4.4'
  24. __title__ = 'Device URI Creation Utility'
  25. __doc__ = "Creates device URIs for local and network connected printers for use with CUPS."
  26.  
  27. # Std Lib
  28. import sys
  29. import re
  30. import getopt
  31. import os
  32.  
  33. # Local
  34. from base.g import *
  35. from base.codes import *
  36. from base import device, utils
  37.  
  38.  
  39. USAGE = [ (__doc__, "", "name", True),
  40.           ("Usage: hp-makeuri [OPTIONS] [SERIAL NO.|USB ID|IP|DEVNODE]", "", "summary", True),
  41.           ("[SERIAL NO.|USB ID|IP|DEVNODE]", "", "heading", False),
  42.           ("USB IDs (usb only):", """"xxx:yyy" where xxx is the USB bus ID and yyy is the USB device ID. The ':' and all leading zeroes must be present.""", 'option', False),
  43.           ("", """(Use the 'lsusb' command to obtain this information. See Note 1.)""", "option", False),
  44.           ("IPs (network only):", 'IPv4 address "a.b.c.d" or "hostname"', "option", False),
  45.           ("DEVNODE (parallel only):", '"/dev/parportX", X=0,1,2,...', "option", False),
  46.           ("SERIAL NO. (usb and parallel only):", '"serial no."', "option", True),
  47.           utils.USAGE_OPTIONS,
  48.           ("To specify the port on a multi-port JetDirect:", "-p<port> or --port=<port> (Valid values are 1\*, 2, and 3. \*default)", "option", False),
  49.           ("Show the CUPS URI only (quiet mode):", "-c or --cups", "option", False),
  50.           ("Show the SANE URI only (quiet mode):", "-s or --sane", "option", False),
  51.           ("Show the HP Fax URI only (quiet mode):", "-f or --fax", "option", False),
  52.           utils.USAGE_LOGGING1, utils.USAGE_LOGGING2, utils.USAGE_LOGGING3,
  53.           utils.USAGE_HELP,
  54.           utils.USAGE_EXAMPLES,
  55.           ("USB:", "$ hp-makeuri 001:002", "example", False),
  56.           ("Network:", "$ hp-makeuri 66.35.250.209", "example", False),
  57.           ("Parallel:", "$ hp-makeuri /dev/parport0", "example", False),
  58.           ("USB or parallel (using serial number):", "$ hp-makeuri US123456789", "example", False),
  59.           utils.USAGE_SPACE,
  60.           utils.USAGE_NOTES,
  61.           ("1. Example using 'lsusb' to obtain USB bus ID and USB device ID (example only, the values you obtain will differ) :", "", 'note', False),
  62.           ("   $ lsusb", "", 'note', False),
  63.           ("   Bus 003 Device 011: ID 03f0:c202 Hewlett-Packard", "", 'note', False),
  64.           ("   $ hp-makeuri 003:011", "", 'note', False),
  65.           ("   (Note: You may have to run 'lsusb' from /sbin or another location. Use '$ locate lsusb' to determine this.)", "", 'note', True),
  66.           utils.USAGE_SPACE,
  67.           utils.USAGE_SEEALSO,
  68.           ("hp-setup", "", "seealso", False),
  69.         ]
  70.  
  71. def usage(typ='text'):
  72.     if typ == 'text':
  73.         utils.log_title(__title__, __version__)
  74.  
  75.     utils.format_text(USAGE, typ, __title__, 'hp-makeuri', __version__)
  76.     sys.exit(0)
  77.  
  78.  
  79.  
  80. log.set_module('hp-makeuri')
  81. try:
  82.     try:
  83.         opts, args = getopt.getopt(sys.argv[1:], 
  84.                                     'hl:csfp:g', 
  85.                                     ['help', 'help-rest', 'help-man', 'help-desc',
  86.                                       'logging=',
  87.                                       'cups',
  88.                                       'sane',
  89.                                       'fax',
  90.                                       'port=',
  91.                                     ] 
  92.                                   ) 
  93.     except getopt.GetoptError, e:
  94.         log.error(e.msg)
  95.         usage()
  96.         sys.exit(1)
  97.  
  98.     if os.getenv("HPLIP_DEBUG"):
  99.         log.set_level('debug')
  100.  
  101.     log_level = 'info'
  102.     cups_quiet_mode = False
  103.     sane_quiet_mode = False
  104.     fax_quiet_mode = False
  105.     jd_port = 1
  106.  
  107.     for o, a in opts:
  108.  
  109.         if o in ('-h', '--help'):
  110.             usage()
  111.  
  112.         elif o == '--help-rest':
  113.             usage('rest')
  114.  
  115.         elif o == '--help-man':
  116.             usage('man')
  117.  
  118.         elif o == '--help-desc':
  119.             print __doc__,
  120.             sys.exit(0)
  121.  
  122.         elif o in ('-l', '--logging'):
  123.             log_level = a.lower().strip()
  124.             if not log.set_level(log_level):
  125.                 usage()
  126.  
  127.         elif o in ('-c', '--cups'):
  128.             cups_quiet_mode = True
  129.  
  130.         elif o in ('-s', '--sane'):
  131.             sane_quiet_mode = True
  132.  
  133.         elif o in ('-f', '--fax'):
  134.             fax_quiet_mode = True
  135.  
  136.         elif o in ('-p', '--port'):
  137.             try:
  138.                 jd_port = int(a)
  139.             except ValueError:
  140.                 log.error("Invalid port number. Must be between 1 and 3 inclusive.")
  141.                 usage()
  142.  
  143.         elif o == '-g':
  144.             log.set_level('debug')
  145.  
  146.  
  147.     quiet_mode = cups_quiet_mode or sane_quiet_mode or fax_quiet_mode
  148.  
  149.     if quiet_mode:
  150.         log.set_level('warn')
  151.  
  152.     utils.log_title(__title__, __version__)   
  153.    
  154.     if os.getuid() == 0:
  155.         log.warn("hp-makeuri should not be run as root.")
  156.  
  157.     if len(args) != 1:
  158.         log.error("You must specify one SERIAL NO., IP, USB ID or DEVNODE on the command line.")
  159.         usage()
  160.  
  161.     param = args[0]
  162.  
  163.     if 'localhost' in param.lower():
  164.         log.error("Invalid hostname")
  165.         usage()
  166.  
  167.     cups_uri, sane_uri, fax_uri = device.makeURI(param, jd_port)
  168.  
  169.     if not cups_uri:
  170.         log.error("Device not found")
  171.         sys.exit(1)
  172.  
  173.     if cups_quiet_mode:
  174.         print cups_uri
  175.  
  176.     elif not quiet_mode:    
  177.         log.info("CUPS URI: %s" % cups_uri)
  178.  
  179.     if sane_uri:
  180.         if sane_quiet_mode:
  181.             print sane_uri
  182.         
  183.         elif not quiet_mode:
  184.             log.info("SANE URI: %s" % sane_uri)
  185.     
  186.     elif not sane_uri and sane_quiet_mode:
  187.         log.error("Device does not support scan.")
  188.  
  189.     if fax_uri:
  190.         if fax_quiet_mode:
  191.             print fax_uri
  192.         
  193.         elif not quiet_mode:
  194.             log.info("HP Fax URI: %s" % fax_uri)
  195.             
  196.     elif not fax_uri and fax_quiet_mode:
  197.         log.error("Device does not support fax.")
  198.  
  199. except KeyboardInterrupt:
  200.     log.error("User exit")
  201.  
  202. if not quiet_mode:
  203.     log.info("")
  204.     log.info("Done.")
  205.  
  206.